home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / PDGetCurrentResolution.z / PDGetCurrentResolution
Text File  |  1998-10-30  |  3KB  |  67 lines
  1.  
  2.  
  3.  
  4. PPPPDDDDGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttRRRReeeessssoooolllluuuuttttiiiioooonnnn((((3333))))        IIIImmmmpppprrrreeeessssssssaaaarrrriiiioooo         PPPPDDDDGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttRRRReeeessssoooolllluuuuttttiiiioooonnnn((((3333))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      PDGetCurrentResolution - get current printing resolution
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ####iiiinnnncccclllluuuuddddeeee <<<<ppppoooodddd....hhhh>>>>
  13.  
  14.      iiiinnnntttt PPPPDDDDGGGGeeeettttCCCCuuuurrrrrrrreeeennnnttttRRRReeeessssoooolllluuuuttttiiiioooonnnn((((PPPPDDDDIIIInnnnffffooooSSSSttttrrrruuuucccctttt ****iiiinnnnffffoooo,,,,
  15.                                 iiiinnnntttt ****hhhhrrrreeeesssspppp,,,, iiiinnnntttt ****vvvvrrrreeeesssspppp))));;;;
  16.  
  17. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.      _P_D_G_e_t_C_u_r_r_e_n_t_R_e_s_o_l_u_t_i_o_n is a convenience function for determining the
  19.      current printing resolution.
  20.  
  21.      Typically, printers have a single output resolution and the POD
  22.      _P_D_I_n_f_o_S_t_r_u_c_t _h_o_r_i_z_o_n_t_a_l__r_e_s_o_l_u_t_i_o_n and _v_e_r_t_i_c_a_l__r_e_s_o_l_u_t_i_o_n fields provide
  23.      the printing resolution directly. However, certain printers allow
  24.      switching between multiple output resolutions. For these printers the
  25.      current resolution is determined by first parsing the _P_D_S_t_a_t_u_s_S_t_r_u_c_t
  26.      _p_r_i_n_t_e_r__o_p_t_i_o_n_s field for the keyword CCCCuuuurrrrrrrreeeennnnttttRRRReeeessss. The value for this
  27.      keyword will indicate the current horizontal and vertical resolutions. If
  28.      the keyword is not found, the resolutions in the _P_D_I_n_f_o_S_t_r_u_c_t are used.
  29.      The _P_D_G_e_t_C_u_r_r_e_n_t_R_e_s_o_l_u_t_i_o_n function performs the above procedure to
  30.      determine the current resolution.
  31.  
  32. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  33.      _P_D_G_e_t_C_u_r_r_e_n_t_R_e_s_o_l_u_t_i_o_n returns 0 upon successful execution. If an error
  34.      occurs, the function returns -1 and sets _P_D_e_r_r_n_o.
  35.  
  36. EEEEXXXXEEEECCCCUUUUTTTTIIIIOOOONNNN EEEERRRRRRRROOOORRRR CCCCOOOODDDDEEEESSSS
  37.      _P_D_G_e_t_C_u_r_r_e_n_t_R_e_s_o_l_u_t_i_o_n will fail under the following circumstances.
  38.  
  39.      PD_LIBERR_BAD_STRUCT     A NULL structure pointer has been specified.
  40.  
  41. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  42.      PDReadInfo(3), PDReadStatus(3), libpod(3)
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.